Inside Macintosh: QuickTime Components /

Chapter 6 - Sequence Grabber Channel Components / Sequence Grabber Channel Components Reference

Functions / Configuration Functions for Video Channel Components

SGSetVideoRect

The SGSetVideoRect function allows the sequence grabber component to specify a part of the source video image that is to be captured by your channel component.

pascal ComponentResult SGSetVideoRect (SGChannel c, Rect *r);

c

Identifies the channel connection for this operation.

r

Contains a pointer to the dimensions of the rectangle that defines the portion of the source video image to be captured. This rectangle must lie within the boundaries of the source video boundary rectangle, which the sequence grabber can obtain by calling the SGGetSrcVideoBounds function, described in the previous section.

DESCRIPTION

This rectangle must reside within the boundaries of the source video boundary rectangle. The sequence grabber component obtains the dimensions of the source video boundary rectangle by calling the SGGetSrcVideoBounds function. By default, your component should capture the entire video image, as defined by the source video boundary rectangle.

RESULT CODES

cantDoThatInCurrentMode	-9402	Request invalid in current mode
notEnoughMemoryToGrab	-9403	Insufficient memory for record operation
deviceCantMeetRequest	-9408	Device cannot support grabber

SEE ALSO

For video channel components that receive their data from video digitizer components, this function sets the video digitizer component's digitizer rectangle. See the chapter "Video Digitizer Components" in this book for information about video digitizer components.

Main | Page One | What's New | Apple Computer, Inc. | Find It | Contact Us | Help